<html><head><title>Agate Rule Tester Help</title>

<link type = "text/css" rel = "stylesheet" href = "main.css">

</head>

<body>

<table width = "80%" border = "0" cellspacing = "0" cellpadding = "2" class = "titlebar">
<tr>
    <td class = "breadcrumbs">
    	<a href = "index.html">Home</a> -&gt; Issues and Limitations
    </td>
</tr>
<tr>
	<td class = "title">
		<div id = "sectionTitle">Known Issues and Limitations</div>
		<div id = "icon"><img src = "agate48.png"></div>
	</td>
</tr>
</table>

<div id = "content">
While the Agate Rule Tester has been used and tested pretty extensively, there are, of course, problems that 
still exist in this version.  This is not meant to be an all-inclusive list and not all items on this list
are even repairable.
<p>
<ul>
	<li>The tester is usually right 95% of the time.  There are some incredibly unique situations where that
	    the tester and WireSpeed simply won't agree on how the output should look (especially with the more
		complicated regular expressions one can build).  Of course, the tiebreaker is always what WireSpeed
		thinks is right.</li>
	<li>The tester uses only perl at its core to do all the text manipulation one can do in a rule while I'm not 
		positive what WireSpeed uses (I think it's perl in some cases and Java in others).  This can cause some
		of the problems mentioned above.</li>
	<li>The tester does not like hex values and only uses Unicode.  WireSpeed will let you get away with hex.
		When in doubt, use the proper mnemonic to ensure your rule moves between the two correctly.</li>
	<li>I'm still a little new to auto-saves and determining if a file is in a changed state since its
	    last save, so the the app treats everything like an "open as".  You'll need to tell it were to save
		everytime you do so.</li>
	<li>To load or start a new translation, you must quit the app.  It sucks, I know, but there's a problem
	    with the way the JTFileData object is being destroyed (or not being destroyed, as the case is).</li>
	<li>The translated text window has issues displaying long lines broken by spaces.  It wants to wrap the
		text even though there is ample room to display a non-wrapped version.  This is especially true when 
		there are a lot of tabs inline.  This does not affect the viability of the output, however.</li>
	<li>I have written a ART rule uploader and downloader, but I'm not publishing them as they can be 
	    particularly dangerous (especially the uploader).  You are more than welcome to write your own, though.
		If I can discover a safe and reliable way to do uploads, I'll make it part of the application.</li>
	<li>Files must be in a UTF-8 format otherwise the tester will complain that it's opening the file as ASCII 
	    and it'll prompty destroy any wide characters (emdash, thinspace, etc).</li>
</ul>
<p>
<strong>Reporting Bugs</strong>
<br>
Use the forums located on <a href = "https://sourceforge.net/projects/agateruletester">SourceForge</a>.  That way,
if someone else is having your exact same problem, they will know about it as well.  
Make sure you include the version of the tester you are running as well as a verbose description of the problem.  
Saying a rule doesn't work isn't helpful.

</div>


<div id = "menu">
    <div id = "menuTitle">Help Contents:</div>
	<div id = "menuContents">
		<a href = "index.html">Home</a><br>
		<a href = "introduction.html">Meet the Tester Interface</a><br>
		<a href = "base_translations.html">Creating Base Translations</a><br>
		<a href = "what_you_need.html">Resources and Notes</a><br>
		Known Issues/Bugs/Limitations
	</div>
</div>
</body>
</html>
